home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / doors_2 / yaht0392.zip / YATSYSOP.DOC < prev   
Text File  |  1992-03-20  |  12KB  |  292 lines
  1.                      YAHTSEE DOOR  Version 2.02 03/20/92
  2.  
  3. Files on the distribution disk/.zip:
  4.  
  5.                    yahtsee.exe - Executable program
  6.                    y_setup.exe - Use to alter BBS name
  7.                    yahtsee.doc - Instruction file displayed to player
  8.                   yatsysop.doc - This file
  9.                      doorx.bat - Sample door batch file
  10.                   yaht_def.dat - BBS Name Definition
  11.  
  12.  
  13. The following files are created by the program,
  14.  
  15.                   yatusers.dat - Keeps track of current players.
  16.                   yaht_top.bbs - Keeps track of monthly winners.
  17.                    yatbull.bbs - Can be used as an Ascii bulletin
  18.                    yatbull.scr - Can be used as Ansi color bulletin.
  19.  
  20. SETUP
  21.  
  22.    Setting up this game is a snap! Follow these simple instructions and you
  23. can probably have Yahtsee available for your users in less than 10 minutes.
  24. This door is designed to run on Wildcat!, PCBoard, RBBS, Spitfire 3.0  and 
  25. other systems utilizing DOOR.SYS or DORINFOx.DEF.  It will run under
  26. PCBoard 12.0 -> 14.5 versions using pcboard.sys or DOOR.SYS.  Below is
  27. the configuration information for each system.  Setting up the door is
  28. real easy.
  29.  
  30.  
  31. FOR WILDCAT! SYSTEMS:
  32. These instructions assume you are running Wildcat! 2.xx.
  33.  
  34. 1) Copy the files to your games directory.
  35. 2) Edit DOORX.BAT to reflect the proper directory and then rename the file
  36.    for the door number. ex: DOOR5.BAT. This file must reside in your main
  37.    Wildcat! directory. Here is a sample, which works flawlessly on my BBS.
  38.  
  39.             c:
  40.             cd \games
  41.             yahtsee c:\wildcat\callinfo.bbs
  42.             copy yatbull.bbs c:\wildcat\display\bullx.bbs
  43.             copy yatbull.scr c:\wildcat\display\bullx.scr
  44.             cd \wildcat
  45.             cat
  46.  
  47. 3) Run the makewild utility and adjust the number of doors and number of
  48.    bulletins available. Be sure to set the security level accordingly.
  49.  
  50. 4) Edit doors.bbs/scr and bulletin.bbs/scr to let your users know the game is
  51.    available.
  52.  
  53. 5) For Wildcat! version 3.0 use the file door.sys instead of callinfo.bbs.
  54.    There is no need to convert door.sys to a callinfo.bbs format since the
  55.    program will work with either file.
  56.  
  57. FOR PCBOARD SYSTEMS:
  58. 1) Copy the files to your door directory.
  59. 2) Edit DOORX.BAT to reflect the proper directory and then rename the file
  60.    for the door. ex: YAHTSEE     (no .bat extension)              
  61.  
  62.             c:
  63.             cd \pcb\doors
  64.             yahtsee c:\pcb\pcboard.sys 
  65.             copy yatbull.bbs c:\pcb\gen\blt99            
  66.             copy yatbull.scr c:\pcb\gen\blt99g                
  67.             cd \pcb    
  68.             board
  69.  
  70. FOR RBBS, REMOTE ACCESS SYSTEMS and others using DORINFOX.DEF:
  71. 1) Copy the files to your games directory.
  72. 2) Edit DOORX.BAT to reflect the proper directory and then rename the file
  73.    for the door and node number.
  74.  
  75.             c:
  76.             cd \rbbs\doors
  77.             yahtsee c:\rbbs\dorinfo1.def 
  78.             copy yatbull.bbs c:\rbbs\blt99            
  79.             copy yatbull.scr c:\rbbs\gen\blt99g                
  80.             cd \rbbs
  81.             rbbs
  82.  
  83. FOR GAP, SPITFIRE 3.0 and others using DOOR.SYS:
  84. 1) Copy the files to your games directory.
  85. 2) Edit DOORX.BAT to reflect the proper directory and then rename the file
  86.    for the door.
  87.  
  88.             c:
  89.             cd \sf\doors
  90.             yahtsee c:\sf\doors.sys 
  91.             copy yatbull.bbs c:\sf\blt99            
  92.             copy yatbull.scr c:\sf\gen\blt99g                
  93.             cd \sf
  94.             sfire
  95.  
  96.  
  97. Thats all there is to it! If you have ever installed a door before you should
  98. have no problem installing this one. If you have any problems, please feel
  99. free to call me. I would like to see everyone get a chance to enjoy this fun
  100. game. This game can also be run locally.
  101.  
  102. Data File Descriptions:
  103.  
  104.     yatusers.dat - there is room for 200 players. At the end of each month
  105.                    the monthly winner is written to yaht_top.dat and
  106.                    yatusers.dat is cleared. If you find that you need more
  107.                    room for players, I will make the adjustment for you when
  108.                    you register.
  109.  
  110.     yaht_top.dat - this file keeps track of the monthly winners. It has room
  111.                    for 18 months after which time the data will scroll up.
  112.  
  113.     yaht_def.dat - contains the BBS name. This can be altered using the
  114.                    y_setup.exe program.
  115.  
  116.     These files will be created the first time the game is run. Also the
  117.     bulletin files will be updated after each game.
  118.  
  119. LOCAL PLAY:
  120.  
  121.     Wildcat! creates a file called callinfo.bbs when it exits to a door.
  122. When the user returns from the door, Wildcat! deletes this file. As you
  123. can see in the 3rd line of the sample doorx.bat file, the full path is given
  124. to the location of the callinfo.bbs file. To play locally, you must get a
  125. copy of this file before Wildcat! deletes it. The way I did it was simply add
  126. a line to the file before returning to Wildcat! like this:
  127.  
  128.             c:
  129.             cd \games
  130.             yahtsee c:\wildcat\callinfo.bbs
  131.             copy yatbull.bbs c:\wildcat\display\bullx.bbs
  132.             copy yatbull.scr c:\wildcat\display\bullx.scr
  133.             cd \wildcat
  134.    ----->   copy callinfo.bbs c:\
  135.             cat
  136.  
  137.     After a user has entered the door, you will have a copy of the file. Use
  138. an Ascii editor to change the first line in the file to your name. Also on
  139. line 28 is the word REMOTE. Change this to LOCAL so that Yahtsee won't look
  140. for carrier. Then copy the file into the directory where you have Yahtsee
  141. installed and type this:
  142.  
  143.             yahtsee callinfo.bbs
  144.  
  145.     This will allow you to participate in the game without calling in from a
  146. remote location. Keep in mind that doing it this way, you are using the
  147. actual data files which your users are using and you will be added to the
  148. game. I only say this because some users get irate if the Sysop play's. (they
  149. think we have way of cheating, I guess <grin>).
  150.  
  151. SUPPORT FOR NONSTANDARD COM PORTS:
  152.  
  153.     Say you have a non-standard port using a base address of 02E8 and IRQ 5
  154.     then add the line, PORT:02E8:5, as shown below: -------------------|
  155.             c:                                                         |
  156.             cd \games                                                  |
  157.             yahtsee c:\wildcat\callinfo.bbs PORT:02E8:5   <<-----------|
  158.             copy yatbull.bbs c:\wildcat\display\bullx.bbs
  159.             copy yatbull.scr c:\wildcat\display\bullx.scr
  160.             cd \wildcat
  161.             cat
  162.  
  163.     The command PORT:XXXX:X is used as:
  164.  
  165.     PORT is a flag the the program that the following values are to replace
  166.          the default com port addersses and IRQ.
  167.  
  168.     XXXX is the base address of the com port. 02F8 is normally com2 on most
  169.          IBM class machines.
  170.  
  171.        X is the IRQ (interupt request) line.
  172.        
  173.   The door software assumes the following standard port addresses.
  174.    
  175.       COM1: 03F8:4
  176.       COM2: 02F8:3
  177.       COM3: 03E8:4
  178.       COM4: 02E8:3
  179.       
  180.  If your setup require anything different than the above, then you will
  181.  need to add the PORT:XXXX:X to the command line so the door will know
  182.  what port address and irq to use.
  183.  
  184.  
  185. SUPPORT:
  186.  
  187.      I am trying to compile a set of batch files and callinfo, doorinfo or
  188. whatever door structure files are used for implementing the door on systems
  189. other than Wildcat!.  If you are successful in getting this door to work on
  190. PCBoard, Spitfire or any other BBS system, please let me know how it was
  191. done. I have set up a message folder on my BBS for supporting any Sysop's
  192. who may be having difficulty getting this door to run.
  193.  
  194. CHANGES FROM VERSION 1
  195.  
  196.  -- fixed a recurssion problem which was causing a stack overflow if the
  197.     users played multiple games.
  198.  
  199.  -- fixed a problem with the way the program was updating bulletins. The
  200.     program will now properly write both yatbull.bbs (ascii version) and
  201.     yatbull.scr (ansi version).
  202.  
  203.  -- removed shareware support screen.
  204.  
  205.  -- added Yahtsee bonus of 100 points per additional Yahtsee, as long as
  206.     the user didn't already place a 0 in the Yahtsee slot.
  207.  
  208.  -- included y_setup.exe so that Sysop's can now add their BBS name to the
  209.     main menu screen. Y-setup.exe writes to yaht_def.dat.
  210.  
  211.  -- redesigned the way the main menu and scorecard screens are drawn,
  212.     resulting in a much faster display.
  213.  
  214. CHANGES FROM VERSION 2
  215.  
  216.  -- fixed a problem which would display an error message if the users played
  217.     more than 6 games in a row. The message was "Please inform SYSOP that
  218.     YAHT_DEF.DAT could not be found." This would dump the user back to the
  219.     BBS and the bulletins would not reflect the games the user just played
  220.     until after the next time anybody played the game.
  221.  
  222.  -- added support for non-standard COM Ports. Tested on Wildcat! 2.55S.
  223.  
  224. CHANGES FOR VERSION 2.02
  225.  
  226. -- Redefined the total points variable to an unsigned long since a normal
  227.    integer was 'rolling over' at 32k. Should have no more problems with
  228.    users losing all their points above 30,000. To install version 2.02
  229.    you must delete the file yatusers.dat. Since this may make some players
  230.    upset, you may want to wait until the month changes. If you install
  231.    ver 2.02 without deleting the user file, you will get some garbage
  232.    bulletins.
  233.  
  234. PROPOSED CHANGES FOR NEXT RELEASE
  235.  
  236.  -- Working on a screen redraw if the Sysop breaks into chat mode.
  237.  
  238.  -- Thinking about a concept whereby one user could challenge another, to
  239.     make the game more interactive.
  240.  
  241.  
  242. ----------------------------------------------------------------------------
  243. REGISTRATION
  244.  
  245.    Yahtsee has been released as shareware. Unlike many door authors today,
  246. I have not crippled the game in any way. There are no built in time bombs,
  247. registration ID's or any other ploy's. There are no 'registered versions',
  248. so to speak.  This game will run just the same whether you register it or not.
  249. Let your conscience decide if you think my time and energy is valuable. Feel
  250. free to distribute this game to other Sysop's or interested parties, as long
  251. as the files are maintained in their original .ZIP. The files were
  252. authenticated using PKwares -AV code. If the files do not unpack with the -AV
  253. code registered to Toys in the Attic ][, call Toys in the Attic ][ for a
  254. fresh copy.  All my door programs are available for downloading to first
  255. time callers.  Benefits of registration:
  256.  
  257.  -- 1 year free access to the authors BBS. Updates will be available for
  258.     downloading.
  259.  
  260.  -- You will be encouraging the author to write more quality doors.
  261.  
  262.  -- You will be supporting and encouraging the shareware concept.
  263.  
  264.     The amount of money requested for this quality door is insignificant in
  265. comparison to the many hours spent in it's development/test.
  266.  
  267. If you decide to register this door please provide the following information
  268. when you send your check for $20.00.
  269.  
  270.    a. name
  271.    b. address
  272.    c. city/state/zip
  273.    d. home phone
  274.    e. birthdate
  275.    f. password  (don't forget this)
  276.    g. BBS name
  277.    d. BBS phone
  278.  
  279. This info is confidential and will be used to set up an account on Toys in
  280. the Attic ][ as well as for notifying you of updates.
  281.  
  282. Thanks to Rickie Belitz for writing the CKIT library which provided me
  283. with the C functions necessary for development of this door and the prior
  284. development/release of the freeware door, King of Rock-N-Roll.
  285.  
  286. Craig Green
  287. 17 Wren St.
  288. Johnson City, NY 13790
  289. Voice: 607-797-9303
  290. Toys in the Attic ][, 607-797-4522, 3/12/24/*9600 bauds, 8-n-1, 24 hours
  291. * Hayes V-series 9600 baud.
  292.